//----------------------------------------------------------------------------------------------//
//												//
//	Che tipo di programma è questo?								//
//												//
//----------------------------------------------------------------------------------------------//

Questo programma appartiene alla tipologia di indicatori con IA addestrabile.
L'IA integrata è addestrabile, ovvero senza un addestramento preliminare non ha parametri e semplicemente non si avvia.
Se hai ricevuto una versione demo limitata non tramite lo store MQL5.com, dopo averla scaricata,
inserisci manualmente il file nella cartella "Indicatori" del terminale.


//----------------------------------------------------------------------------------------------//
//												//
//	A cosa serve?										//
//												//
//----------------------------------------------------------------------------------------------//

Questo indicatore utilizza un'intelligenza artificiale addestrabile per prevedere l'andamento futuro dei prezzi:

- 10 giorni in anticipo,
- 1,7 giorni in anticipo,
- 5 ore in anticipo,
- 50 minuti in anticipo,
- 10 minuti in anticipo.

Vengono fornite anche informazioni aggiuntive sotto forma di:
- la deviazione prevista del prezzo in punti e
- l'errore previsto in percentuale (se questo valore supera il 50%,
il programma emetterà un avviso).

Questo programma ha un'intelligenza artificiale addestrabile integrata, ovvero, prima di utilizzarlo,
deve essere addestrato su nuovi dati di input.


//----------------------------------------------------------------------------------------------//
//												//
//Come posso ottenere il file di dati di input per addestrare le reti neurali corrispondenti?	//
//												//
//----------------------------------------------------------------------------------------------//

Come farlo è descritto nelle istruzioni corrispondenti utilizzando l'"AI Learn Utility".
L'AI Learning Utility è gratuita e può essere scaricata manualmente dalla
pagina principale del prodotto sul sito web MQL5.


//----------------------------------------------------------------------------------------------//
//												//
//	Descrizione delle opzioni di menu di questo programma.					//
//												//
//----------------------------------------------------------------------------------------------//

Ci sono solo due parametri qui:

- 1) "Mostra commento" - abilita/disabilita la visualizzazione dei commenti nella finestra in cui è in esecuzione il programma.
Questo è necessario se si prevede di utilizzare questo indicatore nel programma MQL5 e, in tal caso,
questo parametro può essere disabilitato.
- 2) "Deviazione" - abilita/disabilita la visualizzazione della deviazione prevista del valore previsto
espressa in punti.


//----------------------------------------------------------------------------------------------//
//												//
//	Test della versione demo di questo programma.						//
//												//
//----------------------------------------------------------------------------------------------//

Prima di effettuare il test, è necessario addestrare l'IA integrata, se non è già stato fatto.
La versione demo gratuita di questo programma, che funziona solo con il tester strategico, è limitata
in modo che il commento sui valori previsti venga visualizzato solo fino
all'inizio di agosto 2025, quindi per un test gratuito, utilizzare l'intervallo di tempo
antecedente a questa data.
In questo caso, è preferibile utilizzare la modalità di test "OHLC su M1" per l'accelerazione, poiché l'indicatore
calcola i nuovi valori solo al momento dell'apertura delle nuove candele.


//----------------------------------------------------------------------------------------------//
//												//
//	Utilizzo di questo indicatore nel tuo programma MQL5.					//
//												//
//----------------------------------------------------------------------------------------------//

Questo indicatore ha 3 buffer di valore che possono essere utilizzati:

a) "0 Buffer" - contiene informazioni sul prezzo previsto, dove sono presenti solo 5 valori:

0) - 10 giorni in anticipo,
1) - 1,7 giorni in anticipo,
2) - 5 ore in anticipo,
3) - 50 minuti in anticipo,
4) - 10 minuti in anticipo.

b) "1 Buffer" - contiene informazioni sulla deviazione prevista
nella forma - (deviazione in punti) * (valore di un punto di prezzo),
dove sono presenti solo 5 valori:

0) - 10 giorni in anticipo,
1) - 1,7 giorni in anticipo,
2) - 5 ore in anticipo,
3) - 50 minuti in anticipo,
4) - 10 minuti in anticipo.

c) "2 Buffer" - contiene informazioni sull'errore previsto
nella forma - (errore in percentuale)/100, ovvero valori da 0 a 1,
dove ci sono solo 5 valori:

0) - 10 giorni in anticipo,
1) - 1,7 giorni in anticipo,
2) - 5 ore in anticipo,
3) - 50 minuti in anticipo,
4) - 10 minuti in anticipo.


//----------------------------------------------------------------------------------------------//
//												//
//	Funzionalità di utilizzo di questo programma.						//
//												//
//----------------------------------------------------------------------------------------------//

Sebbene "AI Learn Utility" utilizzi OpenCL e richieda un dispositivo appropriato, il programma indicatore autonomo esegue tutti i calcoli sulla CPU e non necessita del supporto OpenCL.

Requisiti hardware minimi:

- 20 GB di spazio libero su disco rigido,
- 4 GB di scheda video con supporto OpenCL,
- 16 GB di RAM.

ATTENZIONE: - I file dei parametri AI per ciascun simbolo occupano circa 1 GB.

Questo programma utilizza molti file con parametri di rete neurale dalla
cartella "//Common//Files//SolarTradeSuite//Theia//...", quindi probabilmente ci sono delle limitazioni
nel tester di strategia e su VPS.

Il test delle strategie e l'ottimizzazione con questo indicatore possono probabilmente essere eseguiti solo localmente o
è impossibile utilizzare un cluster di agenti in una rete locale o
è impossibile utilizzare una rete cloud MQL5.

Il test delle strategie e l'ottimizzazione degli advisor, così come il
numero di programmi in esecuzione simultanea al di fuori del tester di strategia, sono
eventualmente limitati dal numero di file aperti contemporaneamente, che è approssimativamente pari a
160 agenti locali ed è descritto in dettaglio nella documentazione tecnica MQL5.

Stesse limitazioni per VPS: questo indicatore non è stato testato per la possibilità di funzionare in
VPS, a causa dell'elevato numero di file con parametri di IA, potrebbe non funzionare.

Prima di iniziare, assicurarsi che siano disponibili almeno 108 candele del timeframe "MN1" o 10 anni dal momento
di avvio di questo programma. Ciò è necessario perché l'IA integrata utilizza
lo storico dei prezzi degli ultimi 9 anni come dati di input per effettuare una previsione.

Al di fuori del tester di strategia, questo programma può essere eseguito su qualsiasi timeframe, ovvero
l'intervallo temporale in cui il programma viene avviato al di fuori del tester di strategia non ha importanza.

Quando si avvia per la prima volta un simbolo precedentemente inutilizzato, è necessario prima addestrare l'IA:
come fare è descritto nelle istruzioni corrispondenti utilizzando l'"Utilità di apprendimento dell'IA".
Si consiglia di utilizzare l'"Utilità di apprendimento dell'IA" il più spesso possibile, ma
approssimativamente non oltre uno o due anni dall'ultimo utilizzo o
se è trascorso un lungo periodo di tempo dall'ultimo addestramento,
o se si osservano cambiamenti significativi nell'andamento del prezzo del simbolo utilizzato.

Tenere presente: "!!! ATTENZIONE: Questa IA può commettere errori: assicuratevi di controllare la correttezza delle sue previsioni!!!".
Il calcolo degli errori e la previsione stessa vengono effettuati utilizzando metodi avanzati di analisi matematica,
statistica e apprendimento automatico, ma il prezzo di uno strumento finanziario può essere influenzato da
altri eventi non presi in considerazione da tali metodi, come intenzioni politiche, eventi ambientali, condizioni meteorologiche, ecc.

Tutti i parametri dell'IA vengono salvati sul disco rigido nella cartella del terminale "//Common//Files//SolarTradeSuite//Theia//...". Se hai un link per scaricare parametri già pronti per l'IA, dopo averli scaricati, copiali lì.

Non dimenticare di creare manualmente una copia di backup dei parametri dell'IA in una cartella separata creata da te.


//----------------------------------------------------------------------------------------------//
//												//
//	Altre domande.										//
//												//
//----------------------------------------------------------------------------------------------//

L'utilità di addestramento AI è gratuita e può essere scaricata manualmente dalla
pagina principale del prodotto sul sito web MQL5.
Tutte le istruzioni sono disponibili e possono essere scaricate manualmente dalla
pagina principale del prodotto sul sito web MQL5. Si prega di leggere attentamente tutte le istruzioni e il
file di licenza prima di porre domande.

1) Non esitate a porre domande nella scheda di discussione sulla pagina dell'indicatore corrispondente sul sito web MQL5.com.

2) Email per comunicazioni: gerasimovadam@gmail.com, tgwls2@gmail.com.